---
target: Umo Editor
keywords: Umo Editor,Tiptap,富文本编辑器,文档编辑器,文档编辑,协同办公,开源编辑器,国产编辑器
description: Umo Editor 是一个基于 Vue3 和 Tiptap 的本土化开源文档编辑器，专为国人用户设计。它提供了强大的文档编辑能力和 AI 创作功能，支持分页模式、Markdown 语法、富文本编辑、多种格式的节点插入、页面样式设置、文档导出与打印等功能。此外，Umo Editor 还支持自定义扩展、多语言设置和暗色主题。
---

import { Badge } from '/components/badge'

# 文件上传配置

用于配置文件上传相关配置。包含允许的文件类型、文件大小限制等。对于文件上传的方法和文件删除的方法，请参阅[方法列表](./methods)。

## 默认配置

```js
{
  file: {
    allowedMimeTypes: [],
    maxSize: 1024 * 1024 * 100, // 100M
    preview: [ // v5.0.0 新增
      { extensions: ['pdf'], url: '{url}' },
      {
        extensions: ['doc', 'docx', 'xls', 'xlsx', 'ppt', 'pptx'],
        url: 'https://view.officeapps.live.com/op/embed.aspx?src={{url}}&amp;wdStartOn=1&amp;wdPrint=0&amp;wdEmbedCode=0',
      },
    ],
  },
}
```

## 配置项说明

### file.allowedMimeTypes

**说明**：允许上传的文件类型，空数组表示允许所有文件类型。

**类型**：`Array`

**默认值**：`[]`。

**可选值**：

合法的[MIME 类型](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Basics_of_HTTP/MIME_types)值。

除此之外，如果要上传同一类型的文件，可以使用 * 来简化配置，如允许上传所有图片，可配置为 `['image/*']`。

### file.maxSize

**说明**：允许上传文件的最大大小，单位为字节(B)。

**类型**：`Number`

**默认值**：`1024 * 1024 * 100` (100M)

### file.preview 

**说明**:预览文件的配置，包括文件类型和预览链接，注意，修改该值会直接覆盖默认值，如果您需要调整预览文件的配置，请在默认值的基础上进行修改。 <Badge theme="success">v5.0.0 新增</Badge>

**类型**: `Array`

**默认值**: 
```js
[
  { extensions: ['pdf'], url: '{url}' },
  {
    extensions: ['doc', 'docx', 'xls', 'xlsx', 'ppt', 'pptx'],
    url: 'https://view.officeapps.live.com/op/embed.aspx?src={{url}}&amp;wdStartOn=1&amp;wdPrint=0&amp;wdEmbedCode=0',
  },
]
```

**可选值**：

- `preview[].extensions`: 支持的文件后缀名数组，参考默认值。
- `preview[].url`: 预览链接，可以是字符串或字符串数组，支持 `{url}` 和 `{{url}}` 两种占位符，分别用于替换文件上传后的 URL 和对 URL 进行 encodeURIComponent 编码。
